home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / compress / arcid104.zip / ARCID.DOC < prev    next >
Text File  |  1993-12-04  |  13KB  |  299 lines
  1.  
  2.     ┌──────────────────────────────┐
  3.     │                              │
  4.     │  ╖────╖            ╖     ┐   │           Archive Identifier
  5.     │  ║    ║            ║     │   │
  6.     │  ║────╢ ┐──┐ ┌──┐  ║ ┌───│   │              Version 1.04
  7.     │  ║    ║ │    │     ║ │   │   │
  8.     │  ╜    ╜ ┘    └──┘  ╜ └───┘   │  (c) Copyright 1992-1993 - Stacy Smith
  9.     │                              │
  10.     └──────────────────────────────┘
  11.  
  12.                                 Courtesy of:
  13.  
  14.                         The Bloom Beacon-Picayune BBS
  15.           Node 1: (919) 557-3845 (USRobotics Courier Dual Standard)
  16.              Node 2: (919) 557-0645 (USRobotics Courier V.32bis)
  17.              Node 3: (919) 557-0745 (USRobotics Courier V.32bis)
  18.                              FidoNet 1:151/106
  19.                                   Intelec
  20.                                  CompuLink
  21.  
  22.                                 Stacy Smith
  23.                             305 Cottonwood Lane
  24.                           Holly Springs, NC 27540
  25.  
  26.  
  27. ┌────────────────────┐
  28. │  1. Introduction:  │
  29. └────────────────────┘
  30.  
  31. Archive Identifier (ARCID) is a derivative of the UpLoadProcessor (ULP) system;
  32. users of ULP do not require this program, as each of the ULP programs have
  33. ARCID's abilities built into it.
  34.  
  35. ARCID is intended for use by people who wish to be able to accurately detect a
  36. archive's format without relying on the file extension, but do not wish to use
  37. ULP. These people may be sysops using EXZTEST, ZIPLAB, ZDCS, FWKCS, etc., or
  38. may be using their own homemade batch files for testing archives, or even other
  39. purposes I haven't thought of.
  40.  
  41. Regardless, ARCID is an extremely simple and fast tool for people who deal with
  42. compressed files on a regular basis.
  43.  
  44.  
  45. ┌──────────────────────────────────────┐
  46. │  2. Features of Archive Identifier:  │
  47. └──────────────────────────────────────┘
  48.  
  49.       ∙ Identifies ARC, ARJ, HYP, LZH, PAK, SQZ, ZIP, ZOO and GIF files,
  50.         regardless of their file extensions (ideal for software distribution
  51.         networks, like .SDN files).
  52.       ∙ Identifies ARJ, LZH, PAK, SQZ and ZIP self-extracting (SFX) archives.
  53.       ∙ Can filter other file types based solely upon file extension.
  54.       ∙ A total of 97 archive formats and files extensions can be defined for
  55.         conditional branching of batch files.
  56.       ∙ Fully network-aware using DOS SHARE-compatible locks.
  57.       ∙ Written in C for optimal speed, using Borland C++ 3.1.
  58.       ∙ Lifetime registration; pay ONCE and your registration number will work
  59.         on all future versions!
  60.  
  61.  
  62. ┌───────────────────────────────────────────────────────┐
  63. │  3. Files Included in the ARCID Distribution Archive  │
  64. └───────────────────────────────────────────────────────┘
  65.  
  66.         ARCID.COM       Archive Identifier processing program.
  67.         PCBTEST.BAT     Sample PCBTEST.BAT file for using ARCID.
  68.         SLOWDRV.BAT     Sample SLOWDRV.BAT file for using ARCID.
  69.         ARCID.DOC       This file.
  70.         HISTORY.TXT     ARCID revision history in reverse order.
  71.         REGISTER.FRM    Registration form for ARCID.
  72.         FILE_ID.DIZ     Internal description file.
  73.  
  74. When you unzip the distribution archive, you should see my PKZIP authenticity
  75. verification stamp, and a '-AV' after every file in the archive:
  76.  
  77.         # SSU301    The Bloom Beacon-Picayune BBS
  78.  
  79. If there are any files missing or added, or the -AV stamp is missing, the
  80. archive has been tampered with. It would be advisable to call my BBS (listed at
  81. the top of this document) for the latest version of ARCID.
  82.  
  83.  
  84. ┌───────────────────────────┐
  85. │  4. Program Requirements  │
  86. └───────────────────────────┘
  87.  
  88. To the best of my knowledge, this program will run on most any machine capable
  89. of running the popular archivers in use today. My BBS setup is DESQview on a
  90. LANtastic network, but other sysops that I have been in contact with have
  91. successfully implemented ULP on setups with CD-ROMs and other varying hardware.
  92.  
  93. ARCID has been developed and tested using archives created by the following
  94. archiving packages:
  95.  
  96.         ARJ 2.10 and higher (by Robert Jung)
  97.         HYPER 2.5 (by P. Sawatzki and K. P. Nischke)
  98.         LHA 2.12 and higher (by Haruyasu Yoshizaki)
  99.         LHarc 1.13c (by Haruyasu Yoshizaki)
  100.         PAK 2.51 (by NoGate Consulting)
  101.         PKPAK 3.61 (by PKWare)
  102.         PKZIP 1.10 and higher (by PKWare)
  103.         SQZ 1.08.2 (by Jonas Hammarberg)
  104.         ZOO 2.01 and higher (by Rahul Deshi)
  105.  
  106. The ARCID system requires DOS 3.x or later, as it uses DOS SHARE-compatible
  107. file reads and writes.
  108.  
  109. ARCID's memory requirements are extremely small (less than 64K). For the batch
  110. file operations, however, it would be a good idea to have as much free
  111. conventional memory as possible (ARCID itself cannot use EMS or XMS memory, and
  112. really couldn't use it if I wanted it to), since the archivers may require a
  113. significant amount of memory.
  114.  
  115.  
  116. ┌───────────────────┐
  117. │  5. Registration  │
  118. └───────────────────┘
  119.  
  120. The ARCID system is not free; nor is ARCID is crippled to force registration.
  121. ARCID is fully functional, and will always remain so. The only variation with
  122. the registered copies is no beg message and time delay.
  123.  
  124. Why register? Besides a clean conscience, you will get a registration code that
  125. will work for all future versions of ARCID, and will remove the message and
  126. time delay at the end of execution of ARCID.
  127.  
  128. The registration fee for your unique code is $8 for non-commercial BBSes. The
  129. registration fee for commercial BBSes, defined if you run your BBS in the
  130. course of a commercial business, or your if BBS turns a profit, is $15. Other
  131. variations are available; refer to the file REGISTER.FRM for all registration
  132. options. Please print the file REGISTER.FRM and fill it out. You can print out
  133. the form by issuing the following command from the DOS prompt:
  134.  
  135.         TYPE REGISTER.FRM > PRN
  136.  
  137.  
  138. ┌───────────────────────────────────────┐
  139. │  6. License, Warranty and Disclaimer  │
  140. └───────────────────────────────────────┘
  141.  
  142. I'll keep this part short and sweet, and dispense with the legal-ese:
  143.  
  144.     License: You are allowed to use ARCID for 30 days, after which you must
  145.         either register ARCID or stop using it completely. ARCID registration
  146.         is a license for your use of ARCID; I retain ownership of the software.
  147.         A single registration applies to a single BBS system, regardless of the
  148.         number of computers used in the system. If you run two or more distinct
  149.         BBS systems on the same computer (with different names), you require
  150.         two or more ARCID registrations. Refer to the registration form for the
  151.         currect pricing structure.
  152.  
  153.     Warranty: There isn't one. The only thing I'll guarantee is that ARCID will
  154.         take up disk space, and will disappear when deleted.
  155.  
  156.     Disclaimer: I'm not responsible for anything bad that happens. ARCID works
  157.         here, but I cannot be held responsible for it not working on your
  158.         computer or doing any damage to hardware or software.
  159.  
  160. If these aren't agreeable with you, then the best thing to do is delete ARCID
  161. right now. I'll do my best to help any user (registered or not) that wants to
  162. use ARCID, and I'll act on bug reports quickly, but I simply cannot and will
  163. not be responsible for anything bad, like lost data, disk crashes, or whatever
  164. else you can think of.
  165.  
  166.  
  167. ┌───────────────────┐
  168. │  7. Installation  │
  169. └───────────────────┘
  170.  
  171. GENERAL:
  172. ────────
  173. Copy the file ARCID.COM into a subdirectory that is included in the DOS path,
  174. so that ARCID may be executed from anywhere. I would suggest your PCB home
  175. directory, usually 'C:\PCB\'.
  176.  
  177. If you are running PCBoard under a network or a multitasking operating system,
  178. you should already have DOS's SHARE.EXE loaded. You must have SHARE loaded in
  179. order to take advantage of the file sharing and locking methods used by the
  180. ARCID program to prevent data loss. (If you are running a single-node system
  181. without a multitasker, SHARE is not needed).
  182.  
  183. Note that for the ARCID program, you can obtain a limited program syntax screen
  184. simply by executing the program with no arguments.
  185.  
  186. FOR UPLOAD TESTING USING 'PCBTEST.BAT':
  187. ───────────────────────────────────────
  188. NOTE: If you are unfamiliar with the operation of PCBTEST.BAT, you will need
  189. to refer to the PCBoard 14.5 manual on pages 200-202 for an explanation of
  190. PCBTEST.BAT and TESTFILE.EXE.
  191.  
  192. As necessary, refer to the sample PCBTEST.BAT file included in this
  193. archive. This simple batch file will test archive integrity and check for
  194. viruses for any of the detectable formats of ARCID. This batch file can
  195. easily be expanded to perform more tests.
  196.  
  197. ARCID.COM is a drop-in replacement of PCBoard's TESTFILE.EXE. If you are
  198. already using TESTFILE.EXE, then simply replace the TESTFILE command in your
  199. batch file with ARCID. For example, if your current PCBTEST.BAT has the
  200. following line:
  201.  
  202.     TESTFILE %1 ZIP ARJ LZH GIF
  203.  
  204. simply change it to:
  205.  
  206.     ARCID %1 ZIP ARJ LZH GIF
  207.  
  208. ARCID will return a DOS errorlevel corresponding to the archive's position in
  209. the extension list. ARCID is capable of automatically detecting the formats
  210. identified by the following extensions, regardless of the file's true
  211. extension:
  212.  
  213.     ARC     for ARC/PKPAK archives
  214.     ARJ     for ARJ and ARJ self-extracting archives
  215.     GIF     for GIF files
  216.     HYP     for HYPER archives
  217.     LZH     for LHA/LHARC and LHA/LHARC self-extracting archives
  218.     PAK     for PAK and PAK self-extracting archives
  219.     SQZ     for SQZ and SQZ self-extracting archives
  220.     ZIP     for PKZIP and PKZIP self-extracting archives
  221.     ZOO     for ZOO version 2.x archives
  222.  
  223. Do not add 'EXE' to the extension list; ARCID will automatically return to
  224. corresponding errorlevel for an identified self-extracting archive.
  225.  
  226.  
  227. ┌───────────────────────────────────────────┐
  228. │  8. Branding with Your Registration Code  │
  229. └───────────────────────────────────────────┘
  230.  
  231. To brand the ARCID executable with your registration code, type the following
  232. command from the DOS prompt:
  233.  
  234.     ARCID BRAND
  235.  
  236. ARCID will then ask you for your registration information (sysop name, BBS
  237. name and registration code). All of this information is case sensitive; you
  238. must enter it exactly as provided to you. After completion, ARCID will insert
  239. the codes inside of the executable, and the beg message will go away.
  240.  
  241. * NOTE: Do not attempt the brand an ARCID.COM executable that has been
  242.         compressed with PKLITE! This will corrupt the file, and may cause
  243.         ARCID to not function properly. If you want to compress ARCID.COM
  244.         *after* branding, that is will work just fine.
  245.  
  246.  
  247. ┌──────────────┐
  248. │  9. Support  │
  249. └──────────────┘
  250.  
  251. If you require support for ARCID, I can be contacted by any of the following
  252. means:
  253.  
  254.     ∙ Fidonet netmail (node:  1:151/106)
  255.     ∙ Internet private mail to "stacy.smith@f106.n151.z1.fidonet.org"
  256.     ∙ Intelec PCBoard conference
  257.     ∙ The Support conference on my BBS (listed at the top of this document),
  258.       which is linked to the Salt Air (PCBoard home system) ULP Support and
  259.       Central Core (ZDCDS home system) ULP Support conferences, as well as the
  260.       Intelec Network and CompuLink Network ULP Support conferences.
  261.  
  262.  
  263. ┌───────────────────────────┐
  264. │  10. The Future of ARCID  │
  265. └───────────────────────────┘
  266.  
  267. ARCID will be supported as long as I'm in the BBSing business (which will be
  268. quite a while...once it's in your blood, you can never shake it <grin>). The
  269. ARCID system will be rapidly expanding it's features; some current plans:
  270.  
  271.       ∙ Install code to detect archives containing explicit paths.
  272.       ∙ Install code to detect defective or hacked archives.
  273.  
  274. If you have any other suggestions, or want other archivers supported, please
  275. contact me by U.S. snail-mail or on my BBS at the number at the top of this
  276. document.
  277.  
  278. Thanks for giving ARCID a try!
  279.  
  280.  
  281. ┌────────────────────────────────┐
  282. │  Appendix A:  DOS Errorlevels  │
  283. └────────────────────────────────┘
  284.  
  285. The errorlevels returned to DOS by the ARCID system programs are consistent
  286. among all of the programs (primarily with the error conditions); the following
  287. is a list of the errorlevels than can be returned by the ARCID programs, along
  288. with which programs return the codes:
  289.  
  290.         0       Successful brand of the ARCID executable
  291.         1-97    Successful execution, archive identified
  292.         98      Successful execution, archive NOT identified
  293.         99      Unsuccessful execution, no arguments passed (help screen
  294.                    displayed)
  295.         101     Unsuccessful brand of the ARCID executable
  296.         110     Unable to allocate heap memory
  297.         112     Invalid registration code
  298.         115     Invalid filename provided by user on command-line
  299.